Screen Reader Distribution
The screen reader related functions in BGT depend upon certain files being included with your application in order to operate. This applies to System Access, and NVDA. Jaws for Windows and Window Eyes come with Active X COM components in their installations that BGT calls upon to perform the requested tasks, which means that nothing needs to be distributed along with your game in order to support these. Please note that older versions of Jaws for Windows do not come with this Active X component. It is unclear at the time of this writing in which version the component was introduced, but our tests indicate that Jaws version 10.0 and above work without problems. We will amend this section in the documentation as soon as we have more specific information regarding exact version numbers.
For System Access and NVDA, BGT calls external dll's that have to be present. By default, the engine expects them to be in the same folder as your game executable, though you can explicitly change the path with the screen_reader_set_library_path function. You may find these dll files in the BGT installation directory/redist/screen_readers. The System Access dll has no explicit license attached to it but is freely distributable, while the NVDA dll is distributed under the terms of the GNU Lesser General Public license. This means that you need to include the file called license.txt along with NVDA's dll (found in the same directory) if you wish to support this screen reader.
When calling the screen reader functions, they all take a parameter that indicates which screen reader to use. You may use the following constants:
- JAWS
- WINDOW_EYES
- SYSTEM_ACCESS
- NVDA